home *** CD-ROM | disk | FTP | other *** search
/ PCGUIA 114 / PC Guia 114.iso / Software / Utils / The Gimp 2.2.1 / gimp-help-2-0.6-setup.exe / {app} / share / gimp / 2.0 / help / en / ch02s08s03.html < prev    next >
Encoding:
Extensible Markup Language  |  2004-12-19  |  8.4 KB  |  188 lines
  1. <?xml version="1.0" encoding="UTF-8" standalone="no"?>
  2. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  3. <html xmlns="http://www.w3.org/1999/xhtml">
  4.   <head>
  5.     <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
  6.     <title>8.3.┬áInstalling New Plugins</title>
  7.     <link rel="stylesheet" href="gimp-help-plain.css" type="text/css" />
  8.     <link rel="stylesheet" href="gimp-help-screen.css" type="text/css" />
  9.     <meta name="generator" content="DocBook XSL Stylesheets V1.66.1" />
  10.     <link rel="start" href="index.html" title="GIMP User Manual" />
  11.     <link rel="up" href="ch02s08.html" title="8.┬áPlugins" />
  12.     <link rel="prev" href="ch02s08s02.html" title="8.2.┬áUsing Plugins" />
  13.     <link rel="next" href="ch02s08s04.html" title="8.4.┬áWriting Plugins" />
  14.   </head>
  15.   <body>
  16.     <div xmlns="" class="navheader">
  17.       <table width="100%" summary="Navigation header">
  18.         <tr>
  19.           <th colspan="3" align="center" id="chaptername">8.┬áPlugins</th>
  20.         </tr>
  21.         <tr>
  22.           <td width="20%" align="left"><a accesskey="p" href="ch02s08s02.html">Prev</a>┬á</td>
  23.           <th width="60%" align="center" id="sectionname">8.3.┬áInstalling New Plugins</th>
  24.           <td width="20%" align="right">┬á<a accesskey="n" href="ch02s08s04.html">Next</a></td>
  25.         </tr>
  26.       </table>
  27.       <hr />
  28.     </div>
  29.     <div class="sect2" lang="en" xml:lang="en">
  30.       <div class="titlepage">
  31.         <div>
  32.           <div>
  33.             <h3 class="title"><a id="gimp-plugins-install"></a>8.3.┬áInstalling New Plugins</h3>
  34.           </div>
  35.         </div>
  36.       </div>
  37.       <p>
  38.       The plugins that are distributed with Gimp don't require any
  39.       special installation.  Plugins that you download yourself do.  
  40.       There are several scenarios,
  41.       depending on what OS you are using and how the plugin is
  42.       structured.  In Linux it is usually pretty easy to install a new
  43.       plugin; in Windows, it is either easy or very hard.  In any
  44.       case, the two are best considered separately.
  45.     </p>
  46.       <div class="simplesect" lang="en" xml:lang="en">
  47.         <div class="titlepage">
  48.           <div>
  49.             <div>
  50.               <h4 class="title"><a id="id3428260"></a>Linux</h4>
  51.             </div>
  52.           </div>
  53.         </div>
  54.         <p>
  55.         Most plugins fall into two categories: small ones whose source
  56.         code is distributed as a single .c file, and larger ones whose
  57.         source code is distributed as a directory containing multiple
  58.         files including a Makefile.
  59.       </p>
  60.         <p>
  61.         For a simple one-file plugin, call it
  62.         <tt class="filename">borker.c</tt>, installing it is just a
  63.         matter of running the command <span><b class="command">gimptool-2.0 --install
  64.         borker.c</b></span>.    This command compiles the plugin and
  65.         installs it in your personal plugin directory,
  66.         <tt class="filename">~/gimp-2.0/plugins</tt> unless you have
  67.         changed it.  This will cause it to be loaded automatically the
  68.         next time you start Gimp.  You don't need to be root to do
  69.         these things; in fact, you shouldn't be.  If the plugin fails
  70.         to compile, well, be creative.
  71.       </p>
  72.         <p> 
  73.         Once you have installed the plugin, how do you activate it?
  74.         The menu path is determined by the plugin itself, so to answer
  75.         this you need to either look at the documentation for the
  76.         plugin (if there is any), or launch the Plugin Description
  77.         dialog (from Xtns/Plugins Details) search the plug-in by 
  78.         its name and look ot the <span class="guilabel">Tree view</span> tab.
  79.         If you still don't find, finally explore the menus or look 
  80.         at the source code in the Register section -- whichever is easiest.
  81.       </p>
  82.         <p>
  83.         For more complex plugins, organized as a directory with
  84.         multiple files, there ought to be a file inside called either
  85.         INSTALL or README, with instructions.  If not, the best advice
  86.         is to toss the plugin in the trash and spend your time on
  87.         something else:  any code written with so little concern for
  88.         the user is likely to be frustrating in myriad ways.
  89.       </p>
  90.         <p>
  91.         Some plugins (specifically those based on the Gimp Plugin
  92.         Template) are designed to be installed in the main system Gimp
  93.         directory, rather than your home directory.  For these, you
  94.         will need to be root to perform the final stage of
  95.         installation ("make install").
  96.       </p>
  97.         <p>
  98.         If you install in your personal plugin directory a plugin that
  99.         has the same name as one in the system plugin directory, only
  100.         one can be loaded, and it will be the one in your home
  101.         directory.  You will receive messages telling you this each
  102.         time you start Gimp.  This is probably a situation best
  103.         avoided. 
  104.       </p>
  105.       </div>
  106.       <div class="simplesect" lang="en" xml:lang="en">
  107.         <div class="titlepage">
  108.           <div>
  109.             <div>
  110.               <h4 class="title"><a id="id3428366"></a>Windows</h4>
  111.             </div>
  112.           </div>
  113.         </div>
  114.         <p>
  115.         Windows is a much more problematic environment for building
  116.         software than Linux.  Every decent Linux distribution comes
  117.         fully supplied with tools for compiling software, and they are
  118.         all very similar in the way they work, but Windows does not
  119.         come with such tools.  It is possible to set up a good
  120.         software-building environment in Windows, but it requires
  121.         either a substantial amount of money or a substantial amount
  122.         of effort and knowledge.
  123.       </p>
  124.         <p>
  125.         Windows est un environnement plus probl├¿matique que Linux pour la construction
  126.         de logiciels. Toute distribution d├⌐cente de Linux vient avec tous les outils
  127.         n├⌐cessaires ├á la compilation de logiciels, et ils ont tous un mode de fonctionnement
  128.         similaire, mais Windows n'offre pas de tels outils. Il est possible de configurer
  129.         un bon environnement de d├⌐veloppement sous Windows, mais cela n├⌐cessite
  130.         une bonne quantit├⌐ d'argent ou de connaissances et d'efforts.
  131.       </p>
  132.         <p>
  133.         What this means in relation to Gimp plugins is the following:
  134.         either you have an environment in which you can build
  135.         software, or you don't.  If you don't, then your best hope is
  136.         to find a precompiled version of the plugin somewhere (or
  137.         persuade somebody to compile it for you), in
  138.         which case you simply need to put it into your personal plugin
  139.         directory.  If you do have an environment in which you can
  140.         build software (which for present purposes means an
  141.         environment in which you can build Gimp), then you no doubt
  142.         already know quite a bit about these things, and just need
  143.         to follow the Linux instructions.
  144.       </p>
  145.         <p>
  146.         If you would like to set up a build environment, and are ready
  147.         for the heroism involved, you can find a reasonably recent
  148.         description of how to go about it in the Gimp Wiki, at <a href="http://wiki.gimp.org/gimp/HowToCompileGimp_2fMicrosoftWindows" target="_top">
  149.         HowToCompileGimp/MicrosoftWindows </a>.  Since it is a
  150.         Wiki, anybody is free to edit it, so please keep it up to date
  151.         by adding advice based on your own experiences.
  152.       </p>
  153.       </div>
  154.       <div class="simplesect" lang="en" xml:lang="en">
  155.         <div class="titlepage">
  156.           <div>
  157.             <div>
  158.               <h4 class="title"><a id="id3428435"></a>Macintosh</h4>
  159.             </div>
  160.           </div>
  161.         </div>
  162.         <p>
  163.         We could use some material here.
  164.       </p>
  165.       </div>
  166.     </div>
  167.     <div class="navfooter">
  168.       <hr />
  169.       <table width="100%" summary="Navigation footer">
  170.         <tr>
  171.           <td width="40%" align="left"><a accesskey="p" href="ch02s08s02.html">Prev</a>┬á</td>
  172.           <td width="20%" align="center">
  173.             <a accesskey="u" href="ch02s08.html">Up</a>
  174.           </td>
  175.           <td width="40%" align="right">┬á<a accesskey="n" href="ch02s08s04.html">Next</a></td>
  176.         </tr>
  177.         <tr>
  178.           <td width="40%" align="left" valign="top">8.2.┬áUsing Plugins┬á</td>
  179.           <td width="20%" align="center">
  180.             <a accesskey="h" href="index.html">Home</a>
  181.           </td>
  182.           <td width="40%" align="right" valign="top">┬á8.4.┬áWriting Plugins</td>
  183.         </tr>
  184.       </table>
  185.     </div>
  186.   </body>
  187. </html>
  188.